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Preface 


Overview of Document 


This manual tells you how to install and start up the OpenWindows™ environ¬ 
ment. You should read these instructions before you install the Open Windows 

software. 

The OpenWindows environment is Sun’s network-based application environ¬ 
ment. It includes: 

□ OPEN LOOK™ Graphical User Interface for Unified UNIXt System 
VR4.1 

□ OpenWindows DeskSet Environment, a suite of integrated personal pro¬ 
ductivity tools. 

□ XView™, an X Window System™ toolkit.^ 

o OPEN LOOK Intrinsics Toolkit (OLIT), a user interface toolkit based on 
the Xt Intrinsics from MIT. 

□ Xii/NeWS™ server, a merger of the X Window System and Sun’s Network- 
extensible Window System (News®). The Xii/News server forms the win¬ 
dow system platform for the OpenWindows environment. 

□ The News Toolkit is an experimental version of a new toolkit for NeWS pro¬ 
grammers. 

The OpenWindows Installation and Start-Up Guide contains four chapters: 

□ Chapter 1, Installing the OpenWindows Software, describes how to load the 
OpenWindows software onto your system from the distribution tape and 
how to access existing OpenWindows software over the network.^ 

□ Chapter 2, Starting Up the OpenWindows Environment, describes how to 
start the XI i/News server. 

□ Chapter 3, Advanced Topics, describes how to run special configurations of 
the Xii/NeWS server, such as multiple displays, international keyboards, and 
special framebuffers. 

t UNIX is a registered trademaiic of AT&T. 

^ OPEN LOOK is a trademark of AT&T. 

^ X Window System is a product of the Massachusetts Institute of Technology. 
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Preface — Continued 


OPEN LOOK Validation 


Other Documents 


□ Chapter 4, SunView Compatibility, describes how to run SunView and 
Open Windows simultaneously on adjacent screens and how to run SunView 
binaries in your OpenWindows environment. It also describes how to con¬ 
vert from a SunView environment to an OpenWindows environment. 

A thorough validation of the OpenWindows product (using the OPEN LOOK 
Graphical User Interface Level 1 Trademark Guide) has been conducted by the 
AT&T Trademark Quality Control Manager. This release of the OpenWindows 
software meets all significant applicable OPEN LOOK Graphical User Interface 
requirements as stated in the AT&T OPEN LOOK Trademark Control 
Specification. 

□ If you are unfamiliar with tape commands or the network environment, read 
the System and Network Administration manual; note that if you intend to 
access the OpenWindows environment through the Network File System, 
you must read Chapter 3 of that manual, entitled Sun Network Services. All 
commands mentioned in the OpenWindows Installation and Start-Up Guide 
are explained in Sections 1 and 8 of the System and Network Administration 
manual. 

□ To learn how to use the OpenWindows environment, see the OpenWindows 
User’s Guide and DeskJet Environment Reference Guide. 

□ To learn more about the Xl l/NeWS server, see the XlHN^VS Server Guide. 

o To learn more about writing xi i programs for the server, see the following 
manuals: 

OpenWindows Release Notes 
Xlimms Server Guide 

XView Reference Manual: Converting SunView Applications 

XView Programming Manual, O’Reilly & Associates 

Xlib Reference Manual, O’Reilly & Associates 

Xlib Programming Manual, O’Reilly & Associates 

X Protocol Reference Manual, O'Reilly & Associates 

OPEN LOOK Intrinsics Toolkit (OLIT) Widget Set Programmer’s 
Guide 

OPEN LOOK Intrinsics Toolkit (OLIT) Widget Set Reference Manual 
Xt Intrinsics Programmer’s Guide (Version II, Revision 4) 

Xt Intrinsics Reference Manual (Version II, Revision 4) 

□ To learn more about writing News programs for the server, see the following 
manuals: 

OpenWindows Release Notes 
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Preface — Continued 


Notational Conventions 


XI1IN0VS Server Guide 
N^S Programmer’s Guide 

PostScript Language Reference Manual, Addison-Wesley 
PostScript Language Tutorial and Cookbook, Addison-Wesley 

□ To leam more about the OPEN LOOK Graphical User Interface, see the fol¬ 
lowing manuals: 

OPEN LOOK Graphical User Interface Functional Specification, 
Addison-Wesley 

OPEN LOOK Graphical User Interface Style Guide, Addison-Wesley 

This manual uses the following notational conventions: 

□ bold listing font 

This font indicates text or code typed at the keyboard. 

□ listing font 

This font indicates information displayed by the computer. It it also used in 
code examples and textual passages to indicate use of the C programming 
language. 

□ sans serif font 

This font is used in code examples to indicate use of the PostScript® 
language orNeWS extensions.^ 

□ bold font 

This font is used in textual passages to indicate names of system-defined 
PostScript language or News objects, and to introduce important terms. 
Xlib routines and types also use bold font in textual passages. 

□ italic font 

This font is used in code examples and textual passages to indicate user- 
specified parameters for insertion into programs or command lines. It is also 
used to indicate special terms or phrases used in textual descriptions. 


3 PostScjiipt is a registered trademaik of Adobe Systems Inc. 
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Installation Overview 




Installing the OpenWindows Software 


This chapter contains OpenWindows installation instructions. (The following 
chapter describes how to start up the OpenWindows environment.) Please read 
all of this chapter before installing the OpenWindows software. 

The following list summarizes the steps required to install the OpenWindows 
software. Each step is discussed in more detail in the following sections of the 
chapter. 

1. Check installation requirements: 

a. Hardware requirements. 

b. Software requirements. 

c. Memory requirements (main memory, disk space, swap space). 

2. Install OpenWindows software from tape or over the network, using one of 
the following two procedures: 

D Load software from tape, as follows: 

a. Make sure you have the correct distribution tape. 

b. Choose a tape drive. 

c. Extract software from tape. 
or 

□ Access software over network, as follows: 

a. Create a directory on which to mount the OpenWindows software. 

b. Mount the existing OpenWindows directory on your new directory. 

3. If you have a standalone system (i.e., one not connected to a network), set up 
a loopback network. 

4. If you are installing into the /usr directory, run Idconf ig. 

5. Go on to Chapter 2 for instmetions on how to start up the server. 


Asun 
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2 OpenWindows Version 2 Installation and Start-Up Guide 


1.1. Checking Installation Make sure you meet all the installation requirements listed in this section before 
Requirements you try to install the OpenWindows software. 


Hardware Requirements 


There are many different display devices (also known as “framebuffers”) avail¬ 
able for Sun workstations. TTie OpenWindows environment is supported on most 
of these devices, but not aU. 


The OpenWindows environment is supported on the following display devices: 

bwtwo The standard monochrome framebuffer on most Sun worksta¬ 
tions, including the SPARCstation series. 

cgtwo An 8-bit color framebuffer available for Sun VME-based 
machines such as the 3/160C and 4/260C. 

cgthree An 8-bit color framebuffer available on SPARCstations and 
Sun386i systems. 

cgf our An 8-bit color framebuffer with 1-bit overlay and enable 

planes, available on the 3/1 IOC, 3/60C, 4/1 IOC, and 4/150C. 
The OpenWindows environment can be configured to run on 
this device in several ways. See Chapter 3, “Advanced 
Topics”. 

cgfive Also known as the GXi. An 8-bit color accelerated frame- 
buffer available on Sun386i systems. 

cgsix Also known as the GX. An 8-bit color accelerated frame- 

buffer with a hardware cursor available on many Sun works¬ 
tations, including the 3/60, 3/80,4/110, and the SPARCsta¬ 
tion series. 

OpenWindows will also run on the following devices, but will not take advan¬ 
tage of the available graphics acceleration: 


gpone An 8-bit color graphics accelerator. 

gptwo In the CXP option, an 8-bit color graphics accelerator. 
OpenWindows does not support the GXP option. 

OpenWindows is not currently supported on the following devices: 

cge ight A 24-bit color framebuffer with 1 -bit overlay and enable 

planes. 

cgnine A 24-bit color framebuffer which is part of the GXP option. 

gptwo In the GXP option, a 24-bit color graphics accelerator. 

To find out which type of framebuffer you have, use the dmesg command to 
examine the kernel probe messages: 



Scan the output for the names of the framebuffers listed in the tables above. For 
more information, see the dmesg(8) reference manual page. 
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Ch!q>ter 1 — Installing the OpenWindows Software 3 


NOTE The dtne sg command is useful only when the system has been rebooted recently. 
After a while, the message buffer may wrap around and the kernel probe mes¬ 
sages may be lost. If this happens, you have to reboot to rffresh the message 
buffer. 

Software Requirements Note the following software requirements for running the OpenWindows 

environment: 

□ Your system must be running SunOS Version 4.0 FCS (or later) on Sun3 and 

Sun4 machines, or 4.0.1 (or later) on Sun 386i machines. 

To check which version your system is running, use the head command to 
print out the first line of the message of the day. 

f ...\ 

example% head -1 /etc/motd 


o You must have installed the SunView-Users Subset from the SunOS tape. 

Memory Requirements To run the OpenWindows software, you must meet the following memory 

requirements: 

□ You must have at least 8000k bytes (8 megab)4;es) of main memory. For 
improved performance, 12 or 16 megabytes is recommended. 

You can use the dmesg command as described in section 1.1 to view diag¬ 
nostic messages. Look for the line that begins “mem =’’. The number 
should be at least 8000k. 


□ You must have at least 41,033k bytes of disk space to install all the 

OpenWindows release components. Note that this is not a requirement if 
you are mounting the OpenWindows software from a remote machine. 


Use the df (1) command to check how much disk space you have. The 
“Avail” coliann shows the amount of free space (in thousands of bytes). For 
example, if you plan to install the OpenWindows software in the default 
directory: 


exainple% df /-asx if on Sun-3 and Sun-4 maclUnes 
a or 

example% df /files # on Sun 386i machines 

example% df /e3q>ort if for heterogeneous servers (see the next section) 


See the section Installing Subsets of the OpenWindows Software, below, for 
information on installing with less than 44,415k bytes of disk space. 

Q You must have at least 20,(XX)k bytes of swap space to run the OpenWin¬ 

dows software. (You are recommended to have at least 24,000k bytes.) 


^sun 

Nr microsystems 
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4 OpenWindows Version 2 Installation and Start-Up Guide 


Use the pstat command to check how much swap space you have: 



The second number on the last line of output is the swap space size (in 
thousands of bytes). 

1.2. Installing the There are two ways to gain access to the OpenWindows software: 

OpenWindows 

Software from Tape □ Load the OpenWindows software from its distribution tape onto a directory 

on your machine. 

□ Moimt onto your machine a directory on another machine on your netwoik 
that already contains the OpenWindows software. 

This section explains how to load the software from tape and the following sec¬ 
tion describes how to mount the software over the network. 

To load the OpenWindows software from tape, you must: 

1. Make sure you have the correct distribution tape (or tapes). 

2. Choose a tape drive (either the one on your local machine or one on another 
machine on your netwoik). 

3. Extract the OpenWindows software from the tape, by following the instruc¬ 
tions described below. 

The OpenWindows The OpenWindows software is distributed on tape in tar format. There are 

Distribution Tape three versions of the tape: one for Sun-3 machines (MC680X0-based), one for 

Sun 386i machines, and one for Sun-4 (SPARC) machines. There are some 
small but important differences in the way the product is installed on the 386i; 
otherwise, the installation procedure is the same for each machine. 


Check the version of the tape against the type of machine you are using. Use the 
arch command to find out what type of machine you have: 



Choosing a Tape Drive You can perform installation in two ways: 

□ Locally 

Local installation occurs when you use the tape drive of the machine on 
which the product is to reside. 
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Chapter 1 — Installing the OpenWindows Software 5 


□ Remotely 

Remote installation occurs when you use the tape drive of a machine other 
than the one on which the product is to reside; the machine whose tape drive 
you use (the remote machine) must have a network connection to the 
machine on which the product is to reside (the local machine). 

In this case, you must be able to access the remote machine by using the 
r sh(l) command. For example, type the following to test whether you have 
access: 

example% rah remotejnacfiinejiame whoaml 

^^_ J 

This command should return the name of your login account, or root, if 
you are the superuser. If it does not, you must make the appropriate 
modifications to one or all of the following files, which reside on the remote 
machine: /etc/passwd, /etc/hosts .equiv, and .rhosts. Seethe 
Communications chapter of the manual System and Network Administration. 

Extracting the Software from To extract the OpenWindows software from the tape, use the 

the Tape extract_unbundled(8) command. Note that you must be root to run this 

command. 

To run extract_unbundled: 

-^ 

example % su # unnecessary if you are togged in as root 

E^assworci: (enter root password) 

example# /usr/etc/extract_unbtmdled 

V__X 

This command causes the OpenWindows installation script to be run; the script 
prompts you for information required to install the OpenWindows software. You 
will need to make the following decisions: 

□ Is the tape drive local or remote? 

If remote, what is the name of the remote machine? 

□ What is the name of the tape drive device? The four most common ones are 
stO, stl, st8, and st9. Consult your system administrator if you need help. 

□ After reading copyright information, do you want to continue installing the 
OpenWindows software? By answering yes, you agree to the terms of the 
copyright agreement. Answering no takes you back to the shell prompt. 

□ Do you want to see a description of the installation script? Answer yes for a 
brief installation walk-through. 

o Do you want to install the entire OpenWindows release? Answer no if you 
are short of disk space. 

If not, do you want to install the End-User OpenWindows configuration? 

Answer yes if you are not going to be programming and you are short of disk 
space. 
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6 OpenWindows Version 2 Installation and Start-Up Guide 


If not, which OpenWindows subsets do you want to install? (They are offered 
one by one.) 

□ Do you want to install a standalone system (if the software is to be run only 
on one machine), or a server (if it is to be networiced)? 

If server, are you installing a homogeneous server (all the client systems 
on your network are of the same machine architecture as the server), or 
a heterogeneous server (some or aU client systems on your network are 
of an architecture different from that of the server)? 

If heterogeneous: 

Do you want to share architecture-independent files among clients 
with different architectures? This saves approximately 10 MB, and 
is recommended. 

Do you want to install OpenWindows for sun4 clients? 

Do you want to install OpenWindows for sun3 clients? 

Do you want to install OpenWindows for sun386 clients? 

Do you want to install into the default installation directories? If not, you 
will be asked to specify your installation directories. 


Installing Subsets of the 
OpenWindows Software 


NOTE 

NOTE 


The entire OpenWindows distribution requires 41,033k bytes. The end-user 
OpenWindows configuration requires 29,156k bytes. It consists of the Base 
Xii/NeWS Component, the xii/NeWS Users’ Subset, the OpenWindows DeskSet 
Environment Subset, the Xii/NeWS Standard Fonts Subset, and the xii/News 
Demo Subset. The optional subsets in the end-user configuration should always 
be installed unless there is a pressing reason to omit them. 

The sizes discussed in this section are for the Sun-4 version of the software. The 
sizes of the components for the other versions are smaller. 

Omitting some of the subsets in the end-user configuration may cause the associ¬ 
ated entries of the default root menu to generate "file; not found” errors, where 
file is the name of a command that was not installed. 


You must always install the Base xii/News component: 

□ The Base Xii/NeWS Component [10,948k bytes] 

This component contains the Xii/News server, essential clients and libraries, 
header and date files, and a minimal selection of fonts. (Users may choose 
to install some or all of the server core fonts, depending on the space con¬ 
straints of the system and the need for a variety of fonts. The Base Xii/News 
Component contains a smaller selection of fonts for those users with space 
constraints.) 
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Chapter 1 — Installing the OpenWindows Software 7 


Each of the following independent subsets may or may not be installed, accord¬ 
ing to your requirements: 

□ XI i/News Standard Fonts Subset [7,856k bytes] 

This subset contains the standard fonts that are not part of the minimal fonts 
included in the Base Xii/NeWS Component. 

□ Xii/NeWS Users’ Subset [2,666k bytes] 

This subset contains useful (but less essential) applications (such as the File 
Manager, Mail Tool, and Calendar Manager) that are not included in the 
BaseXii/NeWS Component; it also contains the on-line manual pages. 

□ OpenWindows DeskSet Environment Subset [3,834k bytes] 

This subset contains the OpenWindows DeskSet Environment clients and 
XView dynamic libraries. 

□ Xii/News Demo Subset [3,852k bytes] 

This subset contains clients and images that demonstrate the graphics capa¬ 
bility of the OpenWindows system. 

□ Xii/News Programmers’ Subset [2,491kbytes] 

This subset contains static libraries and sample source for a few client pro¬ 
grams. 

□ XView Programmers’ Subset [5,368k bytes] 

This subset contains the XView include files, static libraries, demo pro¬ 
grams, and sample source. 

□ OPEN LOOK Intrinsics Toolkit Subset [4,018k bytes] 

This subset contains the OPEN LOOK Intrinsics Toolkit include files, 
libraries, clients, and sample source. 


1.3. Accessing the If you intend to mount the OpenWindows software from another machine, you 

OpenWindows should know the basics of the netwoik file system (NFS). If you have already 

Directory over the installed the OpenWindows software from tape, you can skip this section and go 

Network on to the next. For more information on this topic, refer to fte chapter Sun Net¬ 

work Services in the manual System and Network Administration. 

NOTE The X11/N0VS server and the example programs included with the OpenWindows 

software do not need to run setuid root. Also, none of the OpenWindows 
programs write to the directory in which they are installed. These aspects of the 
OpenWindows software make it easy to run theXlliN^S server from a directory 
mounted over the NFS. 

If the OpenWindows software has been installed on some other machine on your 
network, you can mount the OpenWindows directory across the network on your 
machine and access it using NFS. Accessing files over the network using NFS is 
a cooperative procedure with the machine supplying them and with the adminis¬ 
trator of that machine. Read NFS: The Network File System service in Chapter 2 
of the System Administration for the Sun Workstation manual for a detailed 
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understanding of the steps involved. Then proceed as follows: 

1. Create a directory in which to mount the OpenWindows directory. 

If the directory in which you are going to mount the OpenWindows software 
does not exist, create it using mkdir. You probably need to be root to 
perform this operatioa 

2. Mount the OpenWindows directory in your new directory. 

As root, mount the OpenWindows directory from the machine that has the 
directory on its disk. You do not need to be able to write to the OpenWin¬ 
dows directory; thus, mount it read-only using the ro flag of the mount(8) 
command. 

Example The following example show how to mount from a homogeneous server or a 

heterogeneous server that does not use shared architecture-independent files. It 
assumes that your machine is reader and that you want to mount the 
OpenWindows software from machine example; it also assumes that, on 
machine example, the OpenWindows software resides in /usr/openwin. 
Heterogeneous servers will usually have the OpenWindows software in 
/export/exec/sun[3,4]/openwin. 


/- 

reader% su ^ Not necessary if you have logged in as root 



Password: (enter root password) 



reader# mkdir /usr/openwin 

reader# mount -v --o ro exaut^le:/usr/openwin /usr/openwin 

example:/usr/openwin mounted on /usr/openwin 

reader# exit 

reader% 


■ . __y' 


You can automate the mounting of the OpenWindows directory, so that it hap¬ 
pens automatically when your system boots, by adding a line of the following 
form to your /etc/f stab file (as root): 



The options bg, ro, hard, intr are merely suggested options: read the 
mount(8) and mntent(5) manual pages for an explanation of the various 
options available. 

Example To mount a heterogeneous server that uses shared architecture-independent files, 

you need to mount both the directory for the machine architecture you have 
chosen to install and the directory of shared files. The following example 
assumes that the client machine is a Sun4. 
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Chsqjter 1 — Installing the OpenWindows Software 9 



You can automate the mounting of the OpenWindows directory by adding a line 
of the following form to your /etc/f stab file (as root): 



XI1 or News client programs connect to the Xii/News server using UNIX network 
services; therefore, in order to run the OpenWindows software, you must have a 
network running on your system, even if it is not connected to a physical net¬ 
work. If you have a standalone system (i.e., one not connected to a network), 
you must correctly set up the loopback network, which is a software network 
interface that does not go outside the machine. To set up the loopback network, 
proceed as follows: 

1. Merge into a single line the entry for your machine’s hostname and the entry 
for localhost in the file / etc/hosts: 

r - \ 

127.0.0.1 hostname localhost loghost mailhost 

V __ / 

Here, hostname represents the hostname of your machine. 

2. Comment out all the if conf ig commands in /etc/rc.boot by adding 
a # symbol at the beginning of each line. Note that ififconfigis con¬ 
tained in an if-then statement, you should comment out the entire statement 
to prevent a shell syntax error. For example: 

r - \ 

#if [ ... ]; then 
# ifconfig ... 

#fi 

V ___> 

3. Reboot. 

1.5. Running ldconfig(8) Note that if you have installed the OpenWindows software into /usr (or into a 

directory that is mounted as /usr by an NFS client), the performance-enhancing 
cache for the run-time link-editor (/etc/ld. so, cache) wiU be out of date. 
Run Idconf ig(8) to update the cache. (See the Idconf ig(8) manual page in 
the SunOS Reference Manual.) 


1.4. Configuring a 

Standalone Machine to 
Run the OpenWindows 
Software 
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Starting Up the OpenWindows 

Environment 

This chapter explains how to set up and start your OpenWindows environment. 
(If you have not yet installed the OpenWindows software, see the previous 
chapter, Installing the OpenWindows Software.) Chapter 3, Advanced Topics, 
contains information on how to customize the Xii/NeWS server and how to run 
special configurations with the server, such as multiple displays. Chapter 4, Sun- 
View Compatibility, discusses how to convert from a SunView environment to an 
OpenWindows environment, how to run a SunView environment on a second 
display adjacent to the OpenWindows environment, and how to run SunView 
binaries in the OpenWindows environment. 

Before you start the Xii/News server, you must first perform the following tasks, 
which are discussed in more detail later in this chapter: 

□ If you did not mount or install the OpenWindows software in 
/usr/openwin, set the OPENWINHOME environment variable. 

□ Run the install_f ilemgr program to bind icons to file types. 

□ Run the install_cmgr program to set up the Calendar Manager database 
daemon. 

□ If your system contains a GX, you must install the appropriate GFX system 
software. 

□ If you are a previous Xil user, you must make sure your . xinitrc file 
contains the code supplied in the default file, 

$OPElWINHOME/lib/Xinitrc. If you do not have a . xinitrc file in 
your home directory, you do not need to do anything — one will be created 
for you automatically. 

NOTE If you are a previous OpenWindows user and have created your own custom root 

menu, you need to update the . openwin-menu^/c to reflect the new applica¬ 
tions available in OpenWindows Version 2. If you have a custom root menu in 
another file format, it will need to be converted to the . openwin-menu format. 
See the cvtolwnimenu(7j and buildmenuf/j m< 2 « pages for more informa¬ 
tion. 
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2.1. Setting the 

OPENWINHOME 

Variable 


After you have performed the above preparatory steps, you can start the xii/News 
server as described in section 2.5 of this chapter. 

If you have not mounted or installed the OpenWindows software in 
/usr/openwin, you must set the OPENWINHOME environment variable to the 
directory where you have mounted or installed the OpenWindows software. If 
you use the C shell, set the variable by executing the following command: 

- ' 

exan^le% setenv OPENWINHOME <installed location of OpenWindows> 

< . .. 

If you use the Bourne shell, set the variable by executing the following com¬ 
mands: 

/T;: .... ... ..S’ 

example? OPENWINHOME= Kinstalled location of OpenWindows> 
example? export OPENWINHOME 

. . . ... . 


To prepare to use the File Manager in the OpenWindows environment, you must 
run the install_f ilemgr program. This program sets up file type rules for 
the File Manager, appends entries to /etc/magic, and creates the rules data¬ 
base, /etc/filetype. 

You must also run install_cmgr to prepare to use the Calendar Manager. 
This program sets up the Calendar Manager database daemon to run automati¬ 
cally. 

You must become root and change directories to 
$OPENWINHOME/bin/xviewto run install_f ilemgr and 
install_cmgr: 



2.2. Running 

install_filemgr 
and install_cmgr 
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See the on-line f ilemgr(l) and cm(l) manual pages for more information. 

2.3. Installing the GFX If you are running the OpenWindows environment on a GX, you must install the 

System Software appropriate GFX system software. For systems running SunOS 4.1, install 4.1- 

GFX Revl. For systems running SunOS 4.0.3, install 4.0.3-GFX Rev2. Infor¬ 
mation on installing the GFX system software can be found in the Read This 
First document supplied with the GFX software. Contact your Sun sales 
representative for ordering information. 


2.4. The . xinitrc File If you are not a previous user ofxii and do not have an . xinitrc file in your 

home directory, you can skip this section and go on to the next. 

NOTE The d^ault . xinitrc and . Xdef ault s files which openwin installs are 
copied from the files $OPENWINHOME/lib/Xinitrc and 
$OPENWINHOME/lib/Xdef ault s files. Thus, if you wish to customize 
start-up conditions for all users of the server, you can modify these files (along 
with $OPENWINHOME/lib/openwin-init and 
$OPENWINHOME/lib/openwin-menuJ. 

The openwin shell script creates a standard Xll initialization file in your home 
directory called . xinitrc, which is used by xinit to start clients. (Note that 
you can run openwin or xinit from anywhere in the file system; both pro¬ 
grams look for . xinitrc in $HOME.) If you already have a . xinitrc file, 
the openwin script will not overwrite it. You should edit your . xinitrc file 
to include the initializations in the default file, which is located in 
$OPENWINHOME/lib/Xinitrc. It is particularly important that your .xin¬ 
itrc runs $OPENWlNHOME/lib/openwin-sys to install various keys as 
Xll modifiers and to perform other initializations. 
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# .xinitrc - OpenWindows startup script, 
if [ -f $HOME/.Xdefaults ]; then 

xrdb $HOME/.Xdefaults & # Load Users Xll resource database 

else 

xrdb $OPENWINHOME/lib/Xdefaults & # Load Default Xll resource database 

fi 

$OPENWINHOME/lib/openwin-sys & # OpenWindows system initialization 

# Install function key ”F1” as an Open Look "Help” key 

# This precludes its use by applications 

# If your applications use FI for anything else^ comment out the following line 
xmodmap -e 'keysym FI = Help' 

eval 'svenv -env' 
olwm -3 & 

if [ -X $HOME/.openwin-init ]; then 
$HOME/.openwin-init 

else 

$OPENWINHOME/lib/openwin-init 
fi 

wait 


# SunView binary compatibility 

# OpenLook Window Manager 

# Custom OpenWindows tools 

# Default OpenWindows tools 


The . xinitrc file must be a shell script and it must remain available as long as 
you want your window system to run. Everything except the last program you 
run from . xinitrc should be run in the background. 


2.5. Starting the Xll/NeWS 
Server 

NOTE Starting the OpenWindows environment on top of an existing SunView environ¬ 
ment is not supported. You should exit the SunView environment before you run 
the openwin script. 

For the average user, a shell script called openwin takes care of all the default 
server configuration issues. If the OpenWindows software is installed in the 
default location, /usr/openwin, then you should run 
/usr/openwin/bin/openwin to start the server. (You should start the 
server from your home directory.) 


/-;- 

example% cd 

example% /usr/openwin/bin/openwin 

\— 

N 

If you have not mounted or installed the OpenWindows software in 
/usr/openwin, you should type: 


r 

example^ cd 

example% $OPENWINHOME/bin/openwin 

\ 
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If you have a grayscale monitor, you should start the server using the grayvis 
device modifier: 


NOTE The openwin script sets your path to have the location of the OpenWindows 

versions of the DeskSet tools before the location of the SunView tools of the same 
name. If you are using the C shell, make sure you run the OpenWindows tools 
first when you start the server. Do this by making sure that your . c shr c file 
does not reset your path to have /usr/bin before $OPENWINHOME/bin. It 
is best to move any "set path” lines from your . cshrc file to your . login file 
instead. 


exainple% cd 

exaniple% /usr/openwln/bin/openwin -dev /dev/fb grayvis 
or 

example% $OPENWlNHOME/bin/openiwin -dev /dev/£b grayvis 


2.6. Troubleshooting 


Console Messages If the following message appears on your screen after start-up, ignore it and 

select the “Redisplay” item fiom the root menu to redisplay the screen. 

Window display lock broken after time limit exceeded \ 
by pid nnn 

If the following message appears on your screen after you type openwin, you 
need to install the SunOS Sunview-Users Subset from the SunOS tape: 

Id.so: libsunwindow.so.0: not found 
giving up. 

/usr/openwin/bin/xinit: No such file or directory (errno 2) 

unable to connect to X server 


Incorrect Keyboard Switch Some of the Sun Type 4 keyboards have been shipped from the factory with 
Settings switch settings indicating that they are international keyboards even though they 

are not. 

A Sun Type 4 keyboard is identified by the serial number sticker located in the 
middle of the bottom of the keyboard. This sticker should have an entry such as 
“Model: Type 4”. These keyboards can be identified visually from the top by 
the four LED indicators on the upper right of the keyboard just above the 
numeric keypad. The DIP switches are located behind a plastic panel near one of 
the extensible feet on the bottom of the keyboard. See the documentation pro¬ 
vided with your keyboard for further information. 

The easiest method to determine if the switch settings are correct is to start up 
OpenWindows. If the server starts normally and the keys generate the proper 
characters when inside a Command Tool or a Shell Tool, then the switch settings 
should be correct. The switch settings may need to be reset if the keyboard gen¬ 
erates incorrect characters for some keys (especially the punctuation and shifted 
punctuation keys), or if OpenWindows fails with an error such as the following: 
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ClassKeyboard couldn't initialize the keyboard. 

Process: Oxldbdlc (Unnamed process) Error: undefined 
Stack: (NeWS/interest.ps) marker /BasicKeyDicts marker 
Executing: asciiOOO 

At: {*ascii000 asciiOSO asciiOOL asciiOSO asciiCOO asciiCOO 
asciiCOO asciiCOO) 

In: Reading file('NeWS/interest.ps'^R) 

Sic transit gloria PostScript 
giving up. 

xinit: No such file or directory (errno 2): unable to connect 

to X server 
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Advanced Topics 


This chapter contains additional infonnation on running the Xii/NeWS server and 
customizing your Open Windows environment. These advanced topics include: 

□ How to override the set of applications run by default when you start the 
server. 

a Where to find information on customizing your Open Windows desktop 

environment. 

o Where to find information on customizing PostScript language extension 
files. 

o Where to find information on running xii and News clients remotely. 

□ How to run the OpenWindows environment on multiple screens. 

□ How to set up your cgfour framebuffer to act as two framebuffers. 

□ How to disable the (FI 1 key as a Help key. 

□ How to disable and re-enable the I Compose I key. 

□ How to use the international font and keyboard support. 

□ The format of the OpenWindows tape. 

3.1. Overriding Default The file $0PENWINH0ME/ lib/openwin-init contains a set of default 

Applications applications. When the server is initialized, this file is executed and the applica¬ 

tions are started. 

-— 

#!/bin/sh 

# openwin-init - OpenWindows Xll/NeWS Server default initialization file. 

$OPENWINHOME/bin/xview/cmdtool -Wp 0 0 -Ws 590 77 -C & 

$OPENWINHOME/bin/xview/filemgr -Wp 0 120 -Ws 590 300 & 

..-J 


If you wish to disable this default collection of tools, you should create a 
. openwin-init file by typing the following commands (if you use a C shell): 


WSUil 

Xr microsystems 
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exainple% cd 

example% echo #\!/bin/sh > .openwin-init 
example! chmod +x .openwin-init 


From a Bourne shell, type the following commands: 



Once you have the OpenWindows environment running, you can bring up appli¬ 
cations using the root menu. (See the OpenWindows User’s Guide for informa¬ 
tion on how to use the OpenWindows environment.) If you select the “Save 
Workspace” command in the “Utilities” submenu of the root menu, your 
. openwin-init file is overwritten with the tools you currently have running. 
The next time you start up the server these tools will be started automatically. 

NOTE “Save Workspace” does not store the full pathname of the tools in your 

. openwin-init file. The correct tools will be run when you start the server 
because the openwin script sets up your path properly. Make sure your 
. cshrc file does not reset the path to put /usr/bin before 
$OPENWINHOME/bin. 


3.2. Customizing Your Refer to the OpenWindows User’s Guide and the OpenWindows DeskSet 

Desktop Environment Environment Reference Manual for information on using and customizing your 

desktop. Note that the xview(l) reference manual page has important informa¬ 
tion on X resources, the . Xdef aults file, and generic command-line options 
for the DeskSet tools. This manual page is available on-line and in appendices to 
the OpenWindows DeskSet Environment Reference Manual and theXn/N0VS 
Server Guide. 


3.3. Customizing 

PostScript Language 
Extension Files, if 
Appropriate 


Xll/NeWS supplies various POSTSCRIPT language files that provide support for 
the OpenWindows environment; the files are loaded automatically when the 
OpenWindows software is initialized. You can customize these files to create 
initialization procedures that are appropriate to your needs. Note, however, that 
this is entirely optional. See Chapter 3 in the XI1/News Server Guide, “Using the 
News Protocol” for a description of PostScript language extensibility files and 
how you can customize them. 


3.4. Running Remote 
Clients 


Refer to Chapter 2, “Using the xii Protocol”, and Chapter 3, “Using the NeWS 
Protocol”, in the Xll/N&VS Server Guide for information on how to run Xl l and 
News clients remotely. 


3.5. Running the Server 
with Multiple Screens 


To run a multiple-screen server, take the following steps: 

□ Before you start a multiple-screen server, you need to put instructions in 
your . xinitrc file to start extra copies of the olwm window manager (one 
for each screen). For example, if you have two displays, you might put this 
in your .xinitrc: 


^sun 

XT microsystems 
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eval '$OPENWINHOME/bin/svenv -env -display :0.0' 
$OPENWINHOME/bin/olwin -display :0.0 & 
eval '$OPENWINHOME/bin/svenv -env -display :0.1' 
$OPENWINHOME/bin/olwm -display :0.1 & 


NOTE If you are going to run SunView applications, you must run 
eval '$OPENWINHOME/bin/svenv -env' 

for each screen before you start the window manager. You should put these com¬ 
mands in your . xinitr c file. 

□ Start the server using the -dev command-line option to open win to specify 
the framebuffers for your displays. For example: 



NOTE The order of the devices is important. The first device corresponds to the left 
screen. The second device corresponds to the right screen. 

3.6. Using Cgfour-Based If you have a 3/60C, 3/1 IOC, or 4/1 IOC with a cgfour framebuffer, you can mn 

Framebuffers the Open Windows software in either of the following ways: 

□ In all ten planes of the display — the OpenWindows environment uses the 
overlay plane for the pointer and the eight color planes for your windows. 
This is the default. 

To run the OpenWindows environment in this way, start the server using the 
openwin command: 



Then run the switcher(l) command to make sure the image is displayed 
correctly on the screen. This will properly clear the overlay plane. 

exart 5 >le% switcher -e 0 

V_——-—-■ 

NOTE Ifyou are using all ten planes, executing svjit cher -e 0 temporarily erases 
the cursor. Moving the cursor should make it visible again. 

□ In the overlay plane only (black and white). 

To run the OpenWindows environment in this way, you must first create the 
device file /dev/bwtwoO (if it does not already exist), before you start the 
server. 


®sun 

XT microsystems 
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f —............ 

exaniple% su # Not necessary if you have logged 
root. 

Password: (enter root password) 
examplo# cd /dev 
example# ./M2tKEP£^ bwtwoO 
example# exit 
example% 

in as 


WS:kM& ..I: ^ 


Then start the server using the -dev command-line option to specify the 
framebuffer; 



To make sure the correct image is displayed on the screen, run the 
switcher(l) command: 



□ In the overlay plane (black and white) and the remaining eight (color) 
planes. 

You may run OpenWindows in multiple-screen mode using this 
configuration. Follow the directions for multiple-screen server setup in the 
previous section. Make sure that you also follow the instructions in the 
overlay-plane-only section for creating the bwtwoO device file. After you 
have edited your . xinitrc file to include the appropriate multiple-screen 
instructions, type the following; 



3.7. Disabling FI as a Help The default . xinitrc file installs the I FI I key as an additional I HELP I key 
Key and precludes any other use of the key by applications. If you have a Type 3 

keyboard (check the serial number sticker on the bottom of the keyboard), you 
normally should use the I FI) key as your Help key (since a Type 3 keyboard 
does not have a key labeled “Help”). However, if you have a Type 4 keyboard 
(which does have a key labeled “Help”), or if one of your desktop applications 
requires the I FI) key, you should comment out the following line in your 
. xinitrc file by prepending it with a #: 


/-— - 

# xmodmap -e 'keysym FI = Help' 

'N 


J 
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3.8. Disabling/Enabling the 
Compose Key 


If you do not use the I Compose I key, you can disable it so you don’t have to 
worry about pressing it inadvertently. First, find out the keycode for Multi_key: 


exan^l«% jonodmap -pic | grep Multi^key 
m 0xff20 (Multi key) 



The result will be a line of the form in the example above. The important piece 
of information is the two-digit keycode number at the beginning of the line, 
represented by nn. Use this keycode number to construct the following line in 
your . xinitrc file; 


-\ 

xmodmap -e 'keycode nn = NoSymbol' 

V _ 


To re-enable the I Comtx)se I key, modify the same line in your . xinitrc file: 
- 

xmodmap -e 'keycode nn = Multi_key' 

V_ J 


OpenWindows Version 2 supports 8-bit characters and international keyboards 
on SunOS Release 4.1. Only Type 4 keyboards can be set up as international 
keyboards. A Sun Type 4 keyboard is identified by the seri^ number sticker 
located in the middle of the bottom of the keyboard. This sticker should have an 
entry such as “Model: Type 4”. These keyboards can be identified visually from 
the top by the four LED indicators on the upper right of the keyboard just above 
the numeric keypad. 

DIP Switch Settings To be configured as an international keyboard, the Type 4 keyboard must have its 

DIP switches correctly set. The DIP switches are located behind a plastic panel 
near one of the extensible feet on the bottom of the keyboard. See the documen¬ 
tation provided with your keyboard for further information. 

The following table shows the DIP switch settings for the supported international 
keyboards: 


3.9. International Font and 
Keyboard Support 
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Table 3-1 DIP Settings for International Keyboards 


Country 

Switches 

12345678 

US 

00000000 

FRANCE_BELGIUM 

00000010 

CANADA_FRENCH 

00000011 

DENMARK 

00000100 

GERMANY 

00000101 

ITALY 

00000110 

NETHERLANDS 

00000111 

NORWAY 

00001000 

PORTUGAL 

00001001 

SPAIN_LATINAMERICA 

00001010 

SWEDEN_nNLAND 

00001011 

SWITZERLAND_FRENCH 

00001100 

SWITZERLAND_GERMAN 

00001101 

UK 

00001110 

JAPAN 

00100000 


Enabling International To enable SunOS International support, add the following lines to your . login 

Support file before you start the server: 

--- — ^ 

setenv LC_CTYPE iso_8859_l 
stty cs8 

V___ 


\n the Bourne shell, add the following to your .profile file: 


r 

export LC___CTYPE 

\ 


LC_CTYPE=iso_8859__l 



Stty cs8 


< 


j 


Sun international keyboards for the following locales are supported: 
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Table 3-2 Sun International Keyboards 


Locale 

Keyboard Map File 

France/Belgium 

FranceBe4.ps 

Denmark 

Denmark4.ps 

Germany 

Germany4.ps 

Italy 

Italy4.ps 

Netherlands 

Nether4.ps 

Norway 

Norway4.ps 

Portugal 

Portugal4.ps 

Spain/Latin America 

Spain4.ps 

Sweden/Finland 

SwedenFi4.ps 

Switzerland-French 

SwitzFr4.ps 

Switzerland-German 

SwitzGe4.ps 

UK 

UK4.ps 

US 

US4.ps 


Apart from the two commands mentioned above, no special additional com¬ 
mands ape necessary to enable these keyboards. The server detects the keyboard 
type on start-up and maps key symbols to key stations accordingly. 

Nearly all of the fonts supplied with Open Windows Version 2 support the full 
ISO 8859/1 character set. However, a few fonts do not, and characters in the 
range 128 - 255 will not be displayed when using these fonts. Fonts that do not 
support the full ISO 8859/1 character set include: 

Screen 

Screen-Bold 

fixed 

9x15 

8x13 

8xl3bold 


The xf d utility can be used to check which glyphs are in a font. For reference, 
the LucidaSans-Typewriter font contains a full set of ISO 8859/1 character 
glyphs. For example: 


r ■ . 

example^ xfd -fn courier-‘25 



, J 


Compose Key Support XI 1 clients linked with the Sun version of libXll support Compose key process¬ 

ing through calls to XLookupStringQ. Clients must take care to pass in a valid 
XComposeStatus pointer as the final argument to XLookupStringQ for such 
processing to operate correctly. See Appendix A for a table of valid compose 
key combinations. 

NOTE Although all valid Compose sequences are handled properly, invalid sequences 
are not recognized immediately. If you press the I Compose I key followed by an 
invalid key, the operation will not be aborted until you enter a second key. The 
Compose LED is not functional in this release. 
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Support on SunOS 4.0 and 
SunOS 4.0.3 


NOTE 


NOTE 


SunOS 4.0 and 4.0.3 do not support keyboards other than the US T)^ 3 and US 
Type 4. OpenWindows Version 2 can support international keyboards on SunOS 
4.0 and 4.0.3 with a minimum of configuration. 

Since SunOS 4.0 and 4.0.3 does not support international characters, not all util¬ 
ities process such characters cleanly. Many utilities, such as -viand send- 
mail, strip international characters cf the high bit during processing. 

For all releases, documents containing high-bit characters require release 2.1.1 
of the TranScript software. 

The OpenWindows environment can be configured for a particular keyboard on 
either a per-user or a per-installation basis. A per-user configuration is accom¬ 
plished by creating a file in the user’s home directory and affects the OpenWin¬ 
dows environment only for that user. A per-installation configuration affects all 
users who get the OpenWindows environment from the same location on the 
disk. 

D To configure the OpenWindows environment for another Sim keyboard for 
your own use only, create or modify a .startup.ps file in your home 
directory. This file is used to tell the xii/News server to load a variant set of 
keymappings for the keyboard you are using. For example, if you wanted to 
use the France/Belgium keyboard, put the following into . startup. ps: 


UserProfile begin 

/PrivateKeyTable 

end 


(NeWS/FranceBe4.ps) def 


Then start the server as usual. 

To configure the OpenWindows environment for a different keyboard for all 
users, it is necessary to change files in $OPENWlNHOME/etc/NeWS. 
Thus, it is important that these changes be done by the owner of this direc¬ 
tory (or root). The following example shows how to install the 
France/Belgium keyboard mappings. For other keyboards, instead of 
FranceBe4 . qm, use the . qm file which corresponds to the file names 
listed above. 



example% 

cd $OPENWINHOME/etc/NeWS 



example% 

rav US4 . qm U$4 ^qm. save 



example% 

cp FranceBe4.qm US4.qm 


V 

example% 

openwin 



To undo this keyboard mapping, restart the server after performing the fol¬ 
lowing operations: 


example% cd $OPENWINHOME/etc/NeWS 
exainple% cp US4.qnt.save US4.qm 
example% openwin 
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3.10. The Format of the 
OpenWindows Tape 


The OpenWindows tape consists of the following files: 
□ Copyright File (dd fonnat) 


□ extract_unbundled Scripts (tar fonnat) 

□ Architecture-Dependent Files (tar format) 

□ Architecture-Independent Files (tar format) 

□ Copyright File (dd format) 

In the OpenWindows distribution, the subdirectory $OPENWlNHOME/ share 
contains architecture-independent files. 
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Sun View Compatibility 


This chapter discusses: 

□ How to convert ftom a SunView environment to an Open Windows environ¬ 
ment. 

□ How to run SunView binaries in the OpenWindows environment. 

n How to mn SunView simultaneously with the OpenWindows environment 
on adjacent screens. 

If you are a SunView user who is switching to the OpenWindows environment, 
the following information may make your transition easier. 

□ To customize your OpenWindows environment in the same way as your 
SunView environment, you can convert your . defaults file, used by 
SunView, into an . Xdef aults file, used by the OpenWindows software. 

If you have a .defaults file in your home directory, you should mn the 
convert_to_Xdefaults(l) program in your home directory, as fol¬ 
lows: 

--—----------- 

example% cd 

example% $OPENWXNHOME/bin/3cview/convert_to_Xdefaults .defaults 

_:__ J 

This creates an . Xdef aults file in your home directory that will be used to 
customize your OpenWindows environment when you start the server. 

□ The . openwin-init file in your home directory contains the tools to be 
mn automatically when you start the server. To mn the XView versions of 
the tools you run in your SunView environment, you should list them in the 
. openwin-init file. Note that the command-line arguments for the 
XView tools may be different than the ones for the SunView tools. Refer to 
the reference manual pages for the individual tools for information on avail¬ 
able options and to the xview reference manual page for information on 
options generic to all XView tools. You can also type the name of the tool 
with -help flag to get a listing of the command-line arguments for that tool. 
(Note that . openwin-init is overwritten each time you select the “Save 
Woricspace” item in the root menu in the OpenWindows environment) 


4.1. Converting from the 
SunView to the 
OpenWindows 
Environment 
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4.2. Running SunView 
Binaries 


Starting SunView 
Applications 


Bugs in SunView/xil/News 
Coexistence 

Inconveniences 


You can nm unmodified SunView (or Sun Windows-based) binaries on the 
Xll/NeWS server, thus, SunView windows can be displayed on the screen simul¬ 
taneously with News and Xii windows. If you do so, note the following: 

□ SunView windows always obscure Xii/NeWS windows. (This occurs 
because the root window is managed by Xii/NeWS rather than by the Sun¬ 
View programs; the SunView programs effectively update the display 
without reference to the XIl/NeWS windows.) As a result, Xii/NeWS notices 
may be covered up by SunView windows. Although you may be able to 
close (iconify) the SunView window, you will not be able to repaint the 
Xii/News notifier. You can try pressing the I Return I key, which may initiate 
a default operation. Otherwise, you will have to restart the server. 

□ Each SunView window is surrounded by a white margin; this prevents left¬ 
over cursor images from appearing when the cursor is moved between the 
SunView window and the Xii/News environment. 

o You may need to run the reservecolors utility to reduce colormap 
flashing between XIi/NeWS and SunView applications. See the reser- 
vecolors(l) reference manual page for more information. 

□ Multiple SunView applications may run at the same time. 

□ Cut and paste selections can be exchanged between Xii/News and SunView 
programs. However, secondary selections between the two environments 
should not be attempted. 

□ Old versions (back to 1.1) of SunWindows-based applications work as weU 
as they would under SunView. 

To start a SunView application, type the application’s full pathname. SunView 
applications are typically stored in /usr/bin, or (in SunOS 4.1) 
/usr/bin/sunviewl. Thus, the following line starts the SunView mailtool: 


This ability to run SimView programs from Xii/News is useful but not flawless. 
The following subsections describe the problems that exist. 

□ Annoying messages, such as the following, may appear on the console: 

Window display lock broken after time limit exceeded \ 
by pid nnn 

To reduce the occurrence of this problem, adjust the display lock timeout by 
modifying the kernel with the adb(l) command; see Section 7.5, Kernel 
Tuning Options, in the SunView System Programmer’s Guide. Note that the 
above message may appear even after you have quit the SunView applica¬ 
tion. 

□ SunView applications are not affected by the OpenWindows lockscreen util¬ 
ity. Use the SunView lockscreen utility to secure your SunView windows. 


^ ^ ^ 

example% /usr/bin/mailtool 

V_:_ 


microsystems 


Revision A, of 11 June 1990 













Chapter 4 — SunView Compatibility 29 


Screen Damage 


Input Mismatches 


Screen damage sometimes occurs when you open a SunView application over the 

cursor that is on the Xii/News part of the screen. Often you can repair the dam¬ 
age by using the “Refresh” menu command. 

□ Ghost cursors are sometimes left inside SunView windows. 

□ There is a two-second delay in cursor tracking when moving into and out of 
SunView windows. 

o SunView sets up the kb(4S) keyboard driver in the kernel to deliver encoded 
events, while Xii/NeWS uses an unencoded keyboard. The Xii/NeWS server 
resets the keyboard state to SunView encoding when the keyboard focus 
moves into a SunView window and whenXii/NeWS exits; therefore, you 
should not notice the difference. However if Xii/News hangs for some rea¬ 
son, you may be left with the keyboard producing random characters in Sun¬ 
View windows. The program kbd_mode switches the keyboard between 
the different modes; you can login remotely to your machine and type 
kbd_mode -e to reset to SunView mode. 

o Sometimes the keyboard map switch fails to occur, causing the SunView 
application keyboard mapping to be wrong. When this happens, you see 
punctuation characters on the screen when you press letter and number keys. 
To recover, move the cursor out of the SunView window, then back in. 

□ Since the keyboard state is changed when you change the keyboard focus 
between XI i/NeWS and SunView, do not hold any keys down when you 
move the mouse from one environment to the oflier, the environment you 
were in to begin with never sees the key going up, and thus is confused 
about the keyboard’s state when you re-enter it. This may leave you in 
secondary selection mode. You should be able to clear this by pressing the 
[ Stop) key twice (usually (LI I in Xi i/NeWS or SunView). 

If this does not reset the state of the function keys, you can login remotely to 
your machine and type clear_f unct ions(l) to get SunView’s selection 
mechanism out of a constant secondary selection mode. 

If you have SunView and Xil/NeWS running on separate displays, you can 
invoke these operations more conveniently if you add Reset Selection 
clear ftinctions to your SunView rootmenu file. For example: 

"Reset Keyboard" kbd_inode -e 

Note that you can also select the “Reset Input” item in the Xii/News root 
menu to reset the Xii/NeWS input state. 

□ Another problem can occur if a SunView program enters fullscreen access 
mode to prompt the user for keyboard input when the keyboard mode is still 
set to unencoded. An example of this is an application prompting for a 
password before allowing the application to run. A workaround for this is to 
make sure that a SunView application has the keyboard focus before invok¬ 
ing an operation that requires a prompt. 
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Color 


4.3. Running the 

OpenWindows and 
SunView 
Environments 
Simultaneously 


Xii/NeWS and SunView have completely different ideas of the colors which are 
currently installed in the hardware colormap. This can lead to unpleasant color- 
map flashing when the cursor is moved in and out of a SunView window. The 
basic problem is that SunView programs have no knowledge about xii/NeWS 
applications and do not cooperate with the color sharing policies of Xii/News. A 
color SunView application needs the cursor over its window in order to see the 
application’s true colors. 

For example, SunView monochrome programs always use pixel locations 254 
and 255 on an 8-bit color display. Pixel 254 is set to white and pixel 255 is set to 
black. If the colormap of anXii/News application gets installed into the 
hardware and redefines these locations to be red (for example), the SunView win¬ 
dow wiU appear completely red when the cursor is in the Xii/NeWS region and 
will appear normally as black and white when the cursor is in the SunView win¬ 
dow. This is termed colormap flashing. Refer to Chapter 5, “Color Support”, in 
theXil/VeiVS Server Guide for more information on colormap flashing and 
Xii/NeWS color sharing policies. 

It is possible to prevent this colormap flashing effect from happening for selected 
SunView applications. Refer to the reservecolor s(l) reference manual 
page for details. 

If you have a system with two framebuffers, or a cgfour framebuffer set to up to 
act as two framebuffers, you can run the OpenWindows environment on one 
framebuffer and the SunView environment on the other. Note that the names of 
the XView and SunView versions of the DeskSet tools you will be running are 
the same. You must make sure your path is set up correctly to run the SunView 
versions of the programs on the SunView screen and the XView versions of the 
programs on the OpenWindows screen. The SunView programs are located in 
/usr /bin; that path must appear first in your path to run the SunView tools. 
The XView programs are located in $OPENWlNHOME/bin/xview; that path 
must appear first in your path to run the XView tools. (The openwin command 
automatically sets up your path when you start the server.) 

1. The OpenWindows and SunView environments use different keyboard 
encodings. Before you tiy to run the OpenWindows and SunView environ¬ 
ments at the same time, you should add an item to your SunView root menu 
so that you can reset the keyboard encoding, if you need to, using the 

kbd_mode command. Add the following line to your . rootmenu file: 
-—- 

"Reset Keyboard" $OPENWINHOME/bin/kbd_mode -e 
___> 


iNOw, even it you cannot enter cnaracters properly wnen you start up your 
SunView environment, you will be able to reset the keyboard through the 
root menu. 
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2. To Start the OpenWindows environment on one framebuffer, execute the 
openwin command and specify the chosen framebuffer with the -dev 
option. For example: 



3. Reset your path so that the path for the SunView versions of the DeskSet 
tools appears before the path for the XView versions. For example, if you 
are using the C shell: 



If you are using the Bourne shell, use the following commands: 

---^ V 

example$ PATH=/usr/bin:$PATH; export PATH» 

4. Start SunView using the sunview command and specify the second frame- 
buffer with the -d command-line option. For example: 



5. Run the ad jacentscreens command to provide alternating access to the 
two displays. For example, if the bwt wo 0 screen is to the left of the f b 
screen: 


example% adjacentscreens /dev/fb -1 /dev/bwtwoO 

s___i--- 

(i. Check to make sure you can enter characters properly on the screen running 
SunView. If not, select the “Reset Keyboard” item from the root menu. 
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Compose Key Combinations 


You can use the I Compose I key to create characters that may not be available on 
your keyboard. For example, to create the copyright symbol, press: 

[ Compose I (TD (U) 

Note that the order of the second and third keystrokes may be reversed to create 
the same character: 

(Compose I C2D E) 

The following table contains a complete list of I Compose 1 key combinations. 
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Key 1 Key 2 Key 3 Result Symbol Code Symbol Name 


Compose 

SP 

SP 

==> 

NBSP 

Compose 

1 

1 

==> 

i 

Compose 

c 

/ 

==> 


Compose 

C 

/ 

==> 


Compos9 

1 

- 

==> 

£ 

Compose 

L 

- 

==> 

£ 

Compose 

O 

X 

==> 

n 

Compose 

0 

X 

==> 

n 

Compose 

0 

X 

==> 

n 

Compose 

0 

X 

==> 

n 

Compose 

y 

- 

==> 

¥ 

Compose 

Y 

- 

==> 

¥ 

Compose 

1 

1 

==> 

j 

Compose 

s 

o 

==> 

§ 

Compose 

S 

0 

==> 

§ 

Compose 

Tf 

f? 

==> 

•• 

Compose 

c 

o 

==> 

© 

Compose 

C 

0 

==> 

© 

Compose 

- 

a 

==> 

a 

Compose 

- 

A 

==> 

a 

Compose 

< 

< 

==> 

« 

Compose 

- 

r 

==> 

r" 

Compose 

- 

1 

==> 


Compose 

- 

- 

==> 

- 

Compose 

r 

O 

==> 


Compose 

R 

0 

==> 


Compose 

A 

- 

==> 

- 

Compose 

A 

0 

==> 

o 

Compose 

A 

★ 

==> 

0 

Compose 

+ 

- 

==> 

± 

Compose 

A 

2 

==> 

2 

Compose 

A 

3 

==> 

3 

Compose 

\ 

\ 

==> 

' 

Compose 

/ 

u 

==> 

P 

Compose 

P 

1 

==> 

I 

Compose 

P 

f 

==> 

I 

Compose 

A 

• 

==> 

• 



(aO) nobreakspace 
(al) exclamdown 
(a2) cent 
(a2) cent 
(a3) sterling 
(a3) sterling 
(a4) currency 
(a4) currency 
(a4) currency 
(a4) currency 
(a5) yen 
(a5) yen 
(a6) brokenbar 
(a7) section 
(a7) section 
(a8) diaeresis 
(a9) copyright 
(a9) copyright 

(aa) ordfeminine 

(aa) ordfeminine 

(ab) guillemotleft 

(ac) notsign 

(ac) notsign 

(ad) hyphen 

(ae) registered 

(ae) registered 

(af) macron 
(bO) degree 
(bO) degree 
(bl) plusminus 
(b2) twosuperior 
(b3) threesuperior 
(b4) acute 

(b5) mu 
(b6) paragraph 
(b6) paragraph 
(b7) periodcentered 
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Key 1 

Key 2 

Key 3 Result 

. Symbol 

Code 

Symbol Name 

Compose 

f 

, ==> 

A 

(b8) 

cedilla 

Compose 

A 

1 ==> 

1 

(b9) 

onesuperior 

Compose 


o ==> 

s 

(ba) 

masculine 

Compose 


0 ==> 

fi 

(ba) 

masculine 

Compose 

> 

> ==> 

» 

(bb) 

guillemotright 

Compose 

1 

4 ==> 


(be) 

onequarter 

Compose 

1 

2 ==> 

h 

(bd) 

onehalf 

Compose 

3 

4 ==> 


(be) 

threequarters 

Compose 

9 

? ==> 

i 

(bf) 

questiondown 

Compose 

A 

' ==> 

A 

(cO) 

Agrave 

Compose 

A 

' ==> 

A 

(cl) 

Aacute 

Compose 

A 

A ==> 

A 

(c2) 

Acirciimflex 

Compose 

A 

==> 

A 

(c3) 

Atilde 

Compose 

A 

n ==> 

A 

(c4) 

Adiaeresis 

Compose 

A 

★ ==> 

A 

(c5) 

Aring 

Compose 

A 

E ==> 

JE 

(c6) 

AE 

Compose 

C 

. ==> 

Q 

(c7) 

Ccedilla 

Compose 

E 

' ==> 

t 

(c8) 

Egrave 

Compose 

E 

' ==> 

t 

(c9) 

Eacute 

Compose 

E 

A = = > 

t 

(ca) 

Ecircumflex 

Compose 

E 

n ==> 

fi 

(cb) 

Ediaeresis 

Compose 

I 

' ==> 

i 

(cc) 

Igrave 

Compose 

I 

' ==> 

t 

(cd) 

Iacute 

Compose 

I 

A ==> 

1 

(ce) 

Icircumflex 

Compose 

I 

« ==> 

1 

(cf) 

Idiaeresis 

Compose 

D 

- ==> 

D 

(dO). 

ETH 

Compose 

N 

^ ==> 

fj 

(dl) 

Ntilde 

Compose 

0 

' ==> 

6 

(d2) 

Ograve 

Compose 

0 

' ==> 

6 

(d3) 

Oacute 

Compose 

0 

A = = > 

5 

(d4) 

Ocircumflex 

Compose 

0 

^ ==> 

0 

(d5) 

Otilde 

Compose 

0 

n ==> 

5 

(d6) 

Odiaeresis 

Compose 

X 

X ==> 

X 

(d7) 

multiply 

Compose 

0 

/ ==> 

0 

(d8) 

Ooblique 

Compose 

u 

' ==> 

t 

(d9) 

Ugrave 

Compose 

u 

' ==> 


(da) 

Uacute 

Compose 

u 

A ==> 

0 

(db) 

Ucircumflex 

Compose 

u 

n ==> 

0 

(dc) 

Udiaeresis 
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Key 1 

Key 2 

Key 3 ] 

Result 

Compose 

Y 

' ==> 


Compose 

P 

1 ==> 

p 

Compose 

T 

H ==> 

p 

Compose 

s 

s ==> 

R 

Compose 

a 

' ==> 

k 

Compose 

a 

' ==> 

d 

Compose 

a 

^ ==> 

a 

Compose 

a 

~ ==> 

a 

Compose 

a 

" ==> 

a 

Compose 

a 

* ==> 

a 

Compose 

a 

e ==> 

ae 

Compose 

c 

, ==> 

Q 

Compose 

e 

' ==> 

a 

Compose 

e 

' ==> 

a 

Compose 

e 

==> 

a 

Compose 

e 

" ==> 

a 

Compose 

i 

' ==> 

1 

Compose 

i 

' ==> 

1 

Compose 

i 

A ==> 

1 

Compose 

i 

" ==> 

I 

Compose 

d 

- ==> 

5 

Compose 

n 

~ ==> 

fi 

Compose 

o 

' ==> 

6 

Compose 

o 

' ==> 

6 

Compose 

o 

^ ==> 

6 

Compose 

o 

~ ==> 

6 

Compose 

o 

" ==> 

6 

Compose 

- 

: ==> 

■ 7 - 

Compose 

o 

/ ==> 

0 

Compose 

u 

' ==> 

a 

Compose 

u 

' ==> 

li 

Compose 

u 

^ ==> 

Q 

Compose 

u 

" ==> 

u 

Compose 

y 

' ==> 

f 

Compose 

p 

1 ==> 

p 

Compose 

t 

h ==> 

p 

Compose 

Y 

" ==> 

y 



Symbol Code 

Symbol Name 

(dd) 

Yacute 

(de) 

THORN 

(de) 

THORN 

(df) 

ssharp 

(eO) 

agrave 

(el) 

aacute 

(e2) 

acirctimflex 

(e3) 

atilde 

(e4) 

adiaeresis 

(e5) 

aring 

(e6) 

ae 

(el) 

ccedilla 

(e8) 

egrave 

(e9) 

eacute 

(ea) 

ecircumflex 

(eb) 

ediaeresis 

(ec) 

igrave 

(ed) 

iacute 

(ee) 

icircumflex 

(ef) 

idiaeresis 

(fO) 

eth 

(fl) 

ntilde 

(f2) 

ograve 

(f3) 

oacute 

(f4) 

ocircumflex 

(f5) 

otilde 

(f6) 

odiaeresis 

(f7) 

division 

(f8) 

oslash 

(f9) 

ugrave 

(fa) 

uacute 

(fb) 

ucircumflex 

(fc) 

udiaeresis 

(fd) 

yacute 

(fe) 

thorn 

(fe) 

thorn 

(ff) 

ydiaeresis 
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BUILDMENU(l) 


USER COMMANDS 


BUILDMENU(l) 


NAME 

buildmenu - builds an OpenWindows (tNt) Menu from a Sun View style menu file. 

SYNOPSIS 

buildmenu [ -root ] [ -title title ] [ -position position ] [ -pinnable ] [ menufile ] 

DESCRIPTION 

buildmenu converts a SunView menu file into the NeWS toolkit PostScript commands to build the same 
menu under OpenWindows. 

If the filename is missing, the menufile is read from 7.openwin-menu. If the filename is the menufile is 
read from stdin. In any case, the PostScript language is written to stdout. 

The expected usage would be for the user to insert a submenu into the default root menu rather than simply 
copying the default root menu and modifying it. 

For example if you have a SunView style menu in 7.niymenu you would put this line in your .openwin-init 
to append your menu to the default OpenWindows root menu. 

buildmenu 7.mymenu -position 99 -title ‘‘My Tools’’ -pinnable | psh 


The OpenWindows Menu File Format 

The file $OPENWINHOME/lib/openwin-menu contains the specification of the default OpenWindows 
menu. You can change the OpenWindows menu by creating your own file and storing it in your home 
directory with the name .openwin-menu. 

Lines in the file have the following format: The left side is a menu item to be displayed, and the right side 
is a command to be executed when that menu item is chosen. Lines may be continued to the next line by 
putting a backslash at the end of the line to be continued. Blank lines and comment lines beginning with 
’#’ are ignored. 

The menu items can be any string as long as strings with embedded blanks are delimited by double quotes. 
The SunView notion of having the full pathname of an icon file delimited by angle brackets is unsupported 
and the basename(l) of the icon file is used as the item label in place of the icon. 

There are five reserved-word commands that can appear on the right side. 

EXIT Exit OpenWindows (requires confirmation). 

REFRESH Redraw the entire screen. 

MENU This menu item is a pull-right item with a submenu. If a filename follows the MENU 

command, the submenu contents are taken from that file, (shell varaiables and "’s are 
interpreted correctly). Otherwise, all the lines between a MENU command and a match¬ 
ing END command are added to the submenu. 

end Mark the end of a nested submenu. The left side of this line should match the left side 

of a line with a MENU command. If the string PIN follows the END command then this 
submenu has an OpenLook pin on it. 

POSTSCRIPT This rest of the line is to be directly interpreted as PostScript language code when the 
item is invoked. 

If the command is not one of these five reserved-word commands, it is treated as a command line and exe¬ 
cuted. Full shell interpretation is done on the commands. 


Here is a menu file that demonstrates all of these features 
"Mail reader” mailtool 


”My tools" 
"Click to type” 
"Follow mouse” 
"Print selection” 


MENU 7.rootmenu 

POSTSCRIPT /ClickFocus setfocusmode 

POSTSCRIPT /CursorFocus setfocusmode 

news_selection I Ipr 


Xll/NeWS 2.0 


Last change: 9 Jun 1990 


37 











BUILDMENU(l) 


USER COMMANDS 


BUILDMENU(l) 


"Nested menu' 


MENU 


"Nested menu" 

Repaint 

Quit 


"Command Tool" 
"Shell Tool" 

END 

REFRESH 

EXIT 


cmdtool 

shelltool 

PIN 


OPTIONS 


-root 

This replaces the existing rootmenu rather than inserting or changing an item in it. OpenWindows 
uses this mode to install your default menu from "/.openwin-menu or 
$OPENWINHOME/lib/openwin-menu if “/.openwin-menu does not exist. 

-title title 

This sets the name of the menu item you wish to insert. If there already exists an item in the root 
menu with the label "title" then this menu item is replaced by this menu. If you have also set -root 
above then this sets the title of the root menu. 

-position position 

This sets where you would like this item to be inserted in the root menu. This option has no effect if 
you specify -root, since you are replacing the whole root menu. The default is 0, meaning insert at 
the beginning of the root menu. 

-pinnable 

This makes the top level menu you are inserting have an OpenLook pin. The default is to not have 
one. 


FILES 


$OPENWINHOME/lib/openwin-menu 


SEE ALSO 


xnews(l), sunview(l) 
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OPENWIN(l) 


USER COMMANDS 


OPENWIN(l) 


NAME 

openwin - OpenWindows startup script 

SYNOPSIS 

openwin [ options ] 

DESCRIPTION 

The openwin shell script sets up the proper environment for starting the entire OpenWindows package, 
including the xnews(l) window server, olwni(l) XI1 ICCCM OpenLook window manager, and several 
default DeskSet(tm) tools. 

OPTIONS 

There are several options which allow you to tailor the default setup of the xnews(l) server, openwin 
accepts the same command line options as xnews(l). For more information, refer to the xnews(l) manual 
page. 

In addition, openwin accepts the following command line arguments that xnews(l) does not accept: 

[-server xnews] 

This tells openwin which server binary to start. The default is $OPENWINHOME/bin/xnews. 
[-noauth] 

This tells openwin to start the Xll/NeWS server with authorization checking turned off. The 
default is to run with authorization enabled. Running the XlUNeWS server with this option 
enabled, lowers your level of security. It is recommended that this option be not enabled, except 
when explicitly needed. See xnews(l) manual page for more information. 


ENVIRONMENT 

The behavior of openwin can also be tailored by means of the following environment variables: 
OPENWINHOME 

Should be set to the directory in which the server’s directory hierarchy is installed, for instance 
"/usr/local/xnews". Below this directory are the binaries, libraries, fonts, man pages and demos. 
If this is not set the default is ”/home/openwin”. Under most circumstances this is the only vari¬ 
able which needs to be set to run OpenWindows. 

DISPLAY 

By default this is ":0‘’ meaning this xnews server is the first (zero based) one running on this 
machine. If you need to run more that one server on a given machine, use the "-display” option. 

LD_LIBRARY_PATH 

This variable is used by the shared library linker to determine which directories to examine for 
shared libraries. The openwin shell script prepends $OPENWINHOME/lib to this path. 

PATH This is the path searched by shells (i.e. csh, sh, ksh) to find executable programs. 
$OPENWINHOME/bin and $OPENWINHOME/bin/xview are prepended to your path if they were 
not there already. 

NEWSSERVER 

The proper value for running NeWS clients given the specification of the -display argument is put 
into the environment in NEWSSERVER. 

FONTPATH 

xnews(l) searches this path for fonts, $OPENWINHOME/lib/fonts is appended to any existing 
definition of FONTPATH. 

MANPATH 

xnews(l) searches this path for man pages, $OPENWINHOME/share/man is appended to any 
existing definition of MANPATH. 
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OPENWIN(l) 


USER COMMANDS 


OPENWIN(l) 


HELPPATH 

xnews(l) searches this path for help files, $OPENWINHOME/lib/help is appended to any existing 
definition of HELPPATH. 


FILES 

"Axinitrc 

This is the file executed by xinit(l) after the server is up and running. If the user does not have a 
.xinitrc, then a default one is copied from $OPENWINHOME/lib/Xinitrc which contains the fol¬ 
lowing; 

# .xinitrc - OpenWindows startup script, 
if [ -f $HOME/.Xdefaults ]; then 

xrdb $HOME/.Xdefaults & 
else 

xrdb $OPENWINHOME/lib/Xdefaults 
fi 

$OPENWINHOME/lib/openwin-sys & 
eval ‘svenv -env‘ 
olwm -3 & 

if [ -X $HOME/.openwin-init ]; then 
$HOME/.openwin-init 
else 

$OPENWINHOME/lib/openwin-init 
fi 

wait 

If the system is configured with multiple OpenWindows screens by supplying multiple -dev com¬ 
mand line options (see xnews(l)), you need to modify .xinitrc to have multiple invocations of the 
window manager and svenv. The following is an example: 

# .xinitrc - OpenWindows startup script for 2 screens, 
if [ -f $HOME/.Xdefaults ]; then 

xrdb $HOME/.Xdefaults & # Load Users XI1 resource database 

else 

xrdb $OPENWINHOME/lib/Xdefaults & # Load Default XI1 resource database 
fi 

$OPENWINHOME/lib/openwin-sys & # OpenWindows system initialization 
eval ‘svenv -display :0.0 -env‘ # SunView binary compatibility (screen 1) 

olwm -display :0.0 -3 & # OpenLook Window Manager (screen 1) 

eval ‘svenv -display :0.1 -env‘ # SunView binary compatibility (screen 2) 

olwm -display :0.1 -3 & # OpenLook Window Manager (screen 2) 

if [ -X $HOME/.openwin-init ]; then 

$HOME/.openwin-init # Custom OpenWindows tools 

else 

$OPENWINHOME/lib/openwin-init # Default OpenWindows tools 
fi 

wait 

'/.Xdefaults 

This is where XI1 application resources are defined, if this file does not exist it is copied from 
$OPENWINHOME/lib/Xdefaults. 

$OPENWINHOME/lib/Xinitrc 

Site specific changes to the default .xinitrc can be made here and will be propagated to users 


# Load Users XI1 resource database 
& # Load Default XI1 resource database 

# OpenWindows system initialization 

# SunView binary compatibility 

# OpenLook Window Manager 

# Custom OpenWindows tools 

# Default OpenWindows tools 
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OPENWIN(l) 


USER COMMANDS 


OPENWIN(l) 


without an existing .xinitrc. 

$OPENWINHOME/Iib/Xdefaults 

Site specific changes to the default resource database can be made here and will be propagated to 
users without an existing .Xdefaults. 


SEE ALSO 

xnews(l), xinit(l), olwm(l), xrdb(l), svenv(l), sv_xv_sel_svc(l) 


Sun Microsystems 


Last change: 27 Feb 1990 


41 









OPENWIN(l) 


USER COMMANDS 


OPENWIN(l) 


42 


Last change: 27 Feb 1990 


Sun Microsystems 













RESERVECOLORS(l) 


USER COMMANDS 


RESERVECOLORS(l) 


NAME 

reservecolors - reserve colors in the XI 1/NeWS default colormap 
SYNOPSIS 

reservecolors [ -display dpy ] [ -svmono ] [ -invramp ] [ -nokeep ] [ -discard ] 

DESCRIPTION 

reservecolors reserves colors in the default colormap of the default screen at specified pixel locations. It 
sets aside "placeholder” colors corresponding to colors in some other colormap with the intent of reducing 
colormap flashing. The colors and locations specified should be the same as those allocated in this other 
colormap. The presence of these reserved colors causes other color allocations to avoid these positions and 
to therefore not flash against the colors in the other colormap. 

Its main purpose is to reduce colormap flashing with Sunview programs running under the Sunview Binary 
Compatibility mode of Xll/NeWS. 

The pixel locations and color values to allocate are taken from standard input. Each line of standard input 
contains the specification for one pixel. An input line has the following format: 

<pixel> <color speo 

<pixel> is an integer value between 0 and 255. <color speo is an XI1 color specification, which is either 
a color name string or a hexadecimal RGB specification. The two fields are separated with whitespace. 
The list of valid color name strings and their corresponding values can be found in 
$OPENWINHOME/lib/rgb.txt. Refer to XParseColor in the Xlib Reference Manual for details on Xll 
hexadecimal RGB specifications. 

The pixels are allocated as read-write (non-sharable) colormap cells, so while the pixels are reserved they 
are unavailable to be shared by XI 1/NeWS applications. 

To deallocate reserved pixels, run reservecolors with the -discard option. The options -svmono and 
-nokeep are ignored when -discard is used. 

A common use of this utility is to reserve the colors Black and White in the same pixel locations used by 
Sunview monochrome programs (e.g. cmdtool). Because of this, a simplified way is provided to specify 
this situation. If -svmono is specified, the colors and pixels used by Sunview monochrome programs are 
reserved. Standard input is ignored in this case. 

Similarly, there is another convenience option called -invramp which can be used to allocate an inverse 
grayscale ramp in pixel locations 2 to 31. This ramp has gray values which proceed from #efefef down to 
#000000 and is compatible with the colors used by FrameMaker 2.0. Again, standard input is ignored 
whenever a convenience option like this is used. 

Both -svmono and -invramp may be used together on the same command line. 

In order to effectively use the feature which reads the pixel locations and color values from standard input, 
you must know the specific pixel locations and color values used by the program (or programs) with which 
you want to reduce colormap flashing. This information may not always be documented and may be 
difficult to figure out, so this particular feature is typically only useful to application developers. 

An invocation of reservecolors is typically added to ' /. xinit rc. It should be placed before the invo¬ 
cation of any program that allocates colors (such as the window manager). To reduce colormap flashing on 
multiple screens, reservecolors should be run once for each screen, and should be placed before the invo¬ 
cation for each screen of any program that allocates colors. 
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If -nokeep is specified, rather than permanently reserving colors in the default colormap, reservecolors 
simply loads the specified values into the hardware colormap. Note: these pixels may lie in unallocated 
areas of the default colormap and their contents may be displaced the next time a colormap is installed. 

This utility can only be used when the default colormap class (visual) for the screen is dynamic. That is to 
say, this utility may not be run when xnews is started with the staticvis device modifier. An error message 
will be printed if this should happen and no colors will be reserved. 

This utility may not always reduce colormap flashing, and in some environments, might actually increase 
it You should use it only if it is effective in your environment. For example, if you reserve too many 
colors the default colormap might fill up, causing XI1 programs which would ordinarily use the default 
colormap to start overflowing into private colormaps. Colormap flashing usually increases when this hap¬ 
pens. Thus, this utility should be used judiciously. 

This utility does not provide a general solution to the problem of colormap flashing. It only suffices to 
reduce colormap flashing for a few selected applications. 

OPTIONS 

-display 

The XI1 display to which to connect. 

-svmono 

Reserves colors compatible with Sunview monochrome programs running under Sunview Binary Com¬ 
patibility mode of Xll/NeWS. These colors currently are "White" at pixel 254 and "Black" at pixel 255. 

-invramp 

Reserves colors compatible with the Sunview program FrameMaker 2.0. 

-nokeep 

Do not allocate the sjxxified colors in the default colormap. Lx)ad the values only into the hardware 
colormap. These colors may be displaced by subsequent colormap installations. 

-discard 

Discard the allocated colors reserved by all previous invocations of reservecolors for the default screen 
of the specified display. 

EXAMPLES 

For example, to set aside the two pixel locations that Sunview monochrome programs use, add the follow¬ 
ing command to "■ /. xinit rc (prior to invoking olwm): 

$OPENWINHOME/bin/reservecolors -svmono 

As another example, suppose we have a hypothetical Sunview color program which uses the following 
pixel locations and colors: 

Red at pixel 0 
Green at pixel 1 
Blue at pixel 2 
Yellow at pixel 3 

To avoid colormap flashing between applications which use the default colormap and this Sunview applica¬ 
tion, add the following command to "* /. xinitrc (prior to invoking olwm): 

$OPENWINHOME/bin/reservecolors «EOF 
ORed 

1 Green 

2 Blue 
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3 Yellow 
EOF 

Instead of using color names, hexadecimal RGB specifications could also have been used: 

$OPENWINHOME/bin/reservecolors «EOF 

0#ffl)000 

l#00fflX) 

2#0000ff 
3 #ffff00 
EOF 


Refer to XParseColor in the Xlib Reference Manual for more information about hexadecimal RGB 
specifications. 

FILES 

■/.xinitrc 
SEE ALSO 

olwm(l), openwin(l), xnews(l) 

Xlib Reference Manual 
XI 1/NeWS Server Guide 
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NAME 

xnews - window system server 
SYNOPSIS 

xnews [ .'display ] [ serveroptions ] [ [ -dev device ] [ deviceoptions ] ]... 

DESCRIPTION 

The xnews command starts the xii/N^s window system server. The server supports both the XI1 and 
News protocols. Clients connect to the server by opening the socket appropriate to the protocol they use. 
The XI1 protocol is described in the X Window System Protocol, Version 11, from MIT. The C language 
binding to the XI1 protocol is described in Xlib - C Language X Interface, Version 11, also from MIT. 

The News protocol is a superset of the PostScript page description language, described in the PostScript 
Language Reference Manual by Adobe Systems, Inc. NeWS extensions to the PostScript language are 
described in TheN^ws Programmer's Guide, from Sun. The C client interface is also described there. 

SERVER OPTIONS 
[ '.display ] 

The server will listen for XI1 and NeWS connections on sockets indexed by display. This allows 
you to run multiple servers on the same machine and still connect to a specific display. 

[ -auth authorization-file ] 

Specifies a file which contains a collection of authorization records used to authenticate access. 
This option is normally used by openwin(l) to initialize the server’s authorization mechanism. 
Using this option will initialize the server’s host-based access list to empty. Connecting client pro¬ 
grams must send correct authorization information to the server at connection time or they will be 
rejected. This is transparently handled by libX for XI1 clients or by libcps for NeWS clients. 
Older versions of libX and libcps may not send authorization information, so older clients may not 
be able to connect to a server started with this option unless the client programs are relinked. 

[ -cubesize small I large ] 

This determines the size of the color cube contained in the StaticColor colormap, which is the 
default colormap used by NeWS programs, small is the default cube size value since it leaves the 
most room for XI1 clients to allocate colors without conflicting with NeWS colors, large will 
generate better looking NeWS rendering, but will increase the chance of conflicts between XI1 
and News colors. 

small provides a color cube with 5 colors along the red axis, 5 along the green axis, and 5 along 
the blue axis. It also provides 15 additional shades of gray above and beyond the grays contained 
in the color cube. This can be described by the syntax: 5x5x5+15. This gives a total of 140 
colors). The large cube size, on the other hand, provides a color cube of the form 5x9x5+15. It 
has a total size of 240 colors. 

[ -defeateventsecurity ] 

This tells xnews to disable the security feature that detects synthetically created events. Any 
event distributed by the server, even if it was created by a client program, will have a synthetic 
field with value false. NeWS events will see this as a false value in the /Synthetic field of events. 
XI1 events will all lack the synthetic bit in the type field. This flag allows clients which need to 
generated synthetic events, such as the journalling demo, to run correctly. Running the XlUNeWS 
server with this option enabled exposes your workstation to many security risks. It is not recom¬ 
mended that this option be enabled except when explicitly needed. 

[ -favorstatic ] 

This option increases the chances of NeWS colors being displayed on the screen. It is intended 
for users who use a lot of NeWS applications. When xnews installs a software colormap into the 
hardware, it must decide what to do for color cells in that software colormap which have not been 
allocated. What it usually does is to look in the default colormap for an allocated cell and load 
this value. Next, if the cell in the default colormap is not allocated either, it just leaves the 
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hardware alone for that cell. What this option does is to force xnews to look in the StaticColor 
map for an allocated cell immediately after the the examination of the default colormap has failed. 
Thus, if this option is used, colors from the StaticColor will get loaded into the hardware more 
often. 

[ -init ’PosTSCRiPT-code’ ] 

The server interprets this PostScript language code to initialize the server. If this option is not 
specified, xnews executes the following: 

(NeWS/init.ps) (r) file cvx exec 

This code fragment sets up the Xll/News server for its normal use. When specifying this argu¬ 
ment, putting single quotes around the PoSTSCRlPT-code will protect it from premature interpreta¬ 
tion by the shell. 

DEVICE OPTIONS 

[ -dev framebulTer ] 

This specifies the framebuffer device which the server should use for display. If this option is not 
set, the default is /dev/fb. Subsequent uses of this option indicate multiple displays on the same 
server. After each -dev option a list of modifiers changes the behavior of the named device. 

[ gray vis ] 

This device modifier tells xnews to use the Grayscale or StaticGray visual as the default 
visual depending on the state of the staticvis device modifier. The default is to use the 
Pseudocolor or Grayscale visual. 

[ staticvis ] 

This device modifier tells xnews to use a StaticColor or StaticGray visual as the default 
visual depending on the state of the grayvis device modifier. The default is to use the 
Pseudocolor or Grayscale visual. 

[ left ][ right ][ top ][ bottom ] 

This indicates where you would like a given screen in relation to the previous one on the 
command line. 

[ pos X y ] 

This indicates where you would like a given screen as an absolute coordinate on the glo¬ 
bal root. 

ENVIRONMENT VARIABLES 

The XI 1/News server recognizes the following environment variables: 

DISPLAY 

Before starting an XI1 application, you can set this environment variable to tell the application 
which server to connect to. If unset, you must specify the server on the application’s command 
line with the -display option. It is of the following form: 

hostnameidisplay.screen 

Here, hostname may be the name of a host, unix, or localhost. The display argument is normally 
0. The .screen argument is optional. 

FONTPATH 

A list of directories, separated by semicolons, telling the server where to look for fonts. If unset, it 
defaults to $OPENWINHOME/lib/fonts. 

LD_LIBRARY_PATH 

This variable is used by the shared library linker to determine which directories to examine for 
shared libraries. It should normally be set to $OPENWINHOME/lib:/usrAib. 


48 


Last change: 23 May 1990 


Sun Microsystems 







XNEWS(l) 


USER COMMANDS 


XNEWS(l) 


NEWSSERVER 

Before starting a News application, you can set this environment variable to tell the application 
which server to connect to. If unset, the application will default to the local server, socket 2000. 
(For information on how to set this environment variable, see the manual page for newsser- 
verstr.) 

OPENWINHOME 

Should be set to the directory in which the server’s directory hierarchy is installed, for instance 
7usr/local/xnews". Below this directory are the binaries, libraries, fonts, man pages and demos. 
If this is not set the default is "/home/openwin". 

FILES 

$OPENWINHOME/etc/NeWS/*.ps 

Startup PostScript language code. 

$OPENWINHOME/lib/fonts/* 

Font library. 

$OPENWINHOME/bin/xnews 
The server. 

'/.startup.ps 

User-definable server customizations, loaded before other system *.ps files. 

7.user.ps 

User-definable server customizations, loaded after other system *.ps files 
Xll PROPERTIES 

xnews creates the following Xll Standard Colormap property on the root window of each configured 8-bit 
indexed color screen: 

Name Atom: XA_RGB_DEFAULT_MAP 

Type Atom: XA_RGB_COLOR_MAP 

Format: 32 

Contents Type: XStandardColormap 

These atoms are predefined and are declared in <X1 l/Xatom.h>. The XStandardColormap struct is defined 
in<Xll/Xutil.h>. 

The value of this property is a single XStandardColormap which contains a description of the NeWS color 
cube in the StaticColor colormap. Only the color portion of the StaticColor colormap is described; the gray 
ramp portion is not described. 

The information contained in this property will vary depending on whether the staticvis device modifier is 
used. 

Refer to the Xlib C Language X Interface for more information on Standard Colormaps. Refer to the 
XI 1/NeWS Server Guide for more information on the StaticColor colormap. 

SEE ALSO 

kbd_mode(l), newsserverstr(l), olwm(l), openwin(l), psh(l), psterm(l) 

NMS Programmer’s Guide 
xiUNews Server Guide 

PostScript Language Reference Manual, Adobe Systems Inc., Addison-Wesley 
X Window System Protocol, Version 11, MIT 
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Xlib - C Language X Interface, Version 11, MIT 

BUGS 

Some parts of the PostScript language have yet to be implemented. See the appendix in the News 
Programmer’s Guide entitled Omissions and Implementation Limits. 

The server is not yet completely robust when it runs out of memory. This out-of-memory condition occurs 
because swap space has been used up. Swap space is a resource that is shared by all the processes running 
on your machine. 

When running SunView 1 programs, you may see Window display lock broken... messages. 

If you do not have a console window, messages to the console disrupt the entire window system display. 

Anyone who can gain access (legitmately or otherwise) to the system on which the server is running, or to 
any system allowed to access the server, has, through either the XI1 or the News protocol, unrestricted 
access to the resources of the server. They can monitor the keyboard and the mouse, read information from 
the screen, and interfere with the operation of other clients. 

TRADEMARK 

PostScript is a registered trademark of Adobe Systems Inc. 
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